home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 17 / CU Amiga Magazine's Super CD-ROM 17 (1997)(EMAP Images)(GB)[!][issue 1997-12].iso / CUCD / Programming / Make / source / README.W32 < prev    next >
Encoding:
Text File  |  1997-09-16  |  6.0 KB  |  162 lines
  1. Port of GNU make to Windows NT and Windows 95
  2. Builds natively with MSVC 2.x or MSVC 4.x compilers.
  3.  
  4. To build with nmake on Windows NT or Windows 95:
  5.  
  6.     1. Make sure cl.exe is in your %Path%. Example:
  7.  
  8.         set Path=%Path%;c:/msdev/bin
  9.  
  10.     2. Make sure %include% is set to msvc include directory. Example:
  11.  
  12.         set include=c:/msdev/include
  13.  
  14.     3. Make sure %lib% is set to msvc lib directory. Example:
  15.  
  16.         set lib=c:/msdev/lib
  17.  
  18.     4. nmake /f NMakefile
  19.  
  20.  
  21. There is a bat file (build_w32.bat) for folks who have fear of nmake.
  22.  
  23. Outputs:
  24.  
  25.     WinDebug/make.exe
  26.     WinRel/make.exe
  27.  
  28.  
  29. -- Notes/Caveats --
  30.  
  31. GNU make and sh.exe:
  32.  
  33.     This port prefers you have a working sh.exe somewhere on your
  34.     system. If you don't have sh.exe, port falls back to
  35.     MSDOS mode for launching programs (via a batch file).
  36.     The MSDOS mode style execution has not been tested too
  37.     carefully though (I use GNU bash as sh.exe).
  38.  
  39.     There are very few true ports of Bourne shell for NT right now.
  40.     There is a version of GNU bash available from Cygnus gnu-win32
  41.     porting effort.     Other possibilities are to get the MKS version
  42.     of sh.exe or to build your own with a package like
  43.     NutCracker (DataFocus) or Portage (Consensys).
  44.  
  45.     Tivoli uses a homegrown port of GNU bash which is not (yet)
  46.     freely available. It may be available someday, but I am not in control
  47.     of this decision nor do I influence it. Sorry!
  48.  
  49. GNU make handling of drive letters in pathnames (PATH, vpath, VPATH):
  50.  
  51.     There is a caveat that should be noted with respect to handling
  52.     single character pathnames on Windows systems.    When colon is
  53.     used in PATH variables, make tries to be smart about knowing when
  54.     you are using colon as a separator versus colon as a drive
  55.     letter.     Unfortunately, something as simple as the string 'x:/'
  56.     could be interpreted 2 ways: (x and /) or (x:/).
  57.  
  58.     Make chooses to interpret a letter plus colon (e.g. x:/) as a
  59.     drive letter pathname.    If it is necessary to use single
  60.     character directories in paths (VPATH, vpath, Path, PATH), the
  61.     user must do one of two things:
  62.  
  63.      a. Use semicolon as the separator to disambiguate colon. For
  64.         example use 'x;/' if you want to say 'x' and '/' are
  65.         separate components.
  66.  
  67.      b. Qualify the directory name so that there is more than
  68.         one character in the path(s) used. For example, none
  69.         of these settings are ambiguous:
  70.  
  71.           ./x:./y
  72.           /some/path/x:/some/path/y
  73.           x:/some/path/x:x:/some/path/y
  74.  
  75.     These caveats affect Windows systems only (Windows NT and
  76.     Windows 95) and can be ignored for other platforms.
  77.  
  78.     Please note that you are free to mix colon and semi-colon in the
  79.     specification of paths.     Make is able to figure out the intended
  80.     result and convert the paths internally to the format needed
  81.     when interacting with the operating system.
  82.  
  83.     You are encouraged to use colon as the separator character.
  84.     This should ease the pain of deciding how to handle various path
  85.     problems which exist between platforms.     If colon is used on
  86.     both Unix and Windows systems, then no ifdef'ing will be
  87.     necessary in the makefile source.
  88.  
  89. GNU make test suite:
  90.  
  91.     I verified all functionality with a slightly modified version
  92.     of make-test-0.4.5 (modifications to get test suite to run
  93.     on Windows NT). All tests pass in an environment that includes
  94.     sh.exe. Tested on both Windows NT and Windows 95.
  95.  
  96. Building GNU make on Windows NT and Windows 95 with Microsoft Visual C
  97.  
  98.     I did not provide a Visual C project file with this port as
  99.     the project file would not be considered freely distributable
  100.     (or so I think). It is easy enough to create one though if
  101.     you know how to use Visual C.
  102.  
  103.     I build the program statically to avoid problems locating DLL's
  104.     on machines that may not have MSVC runtime installed. If you
  105.     prefer, you can change make to build with shared libraries by
  106.     changing /MT to /MD in the NMakefile (or build_w32.bat).
  107.  
  108.     Program has not been built under non-Intel architectures (yet).
  109.  
  110.     I have not tried to build with any other compilers than MSVC.
  111.  
  112. Pathnames and white space:
  113.  
  114.     Unlike Unix, Windows 95/NT systems encourage pathnames which
  115.     contain white space (e.g. C:\Program Files\). These sorts of pathnames
  116.     are legal under Unix too, but are never encouraged. There is
  117.     at least one place in make (VPATH/vpath handling) where paths
  118.     containing white space will simply not work. There may be others
  119.     too. I chose to not try and port make in such a way so that
  120.     these sorts of paths could be handled. I offer these suggestions
  121.     as workarounds:
  122.  
  123.         1. Use 8.3 notation
  124.         2. Rename the directory so it does not contain white space.
  125.  
  126.     If you are unhappy with this choice, this is free software
  127.     and you are free to take a crack at making this work. The code
  128.     in w32/pathstuff.c and vpath.c would be the places to start.
  129.  
  130. SAMBA/NTFS/VFAT:
  131.  
  132.     I have not had any success building the debug version of this
  133.     package using SAMBA as my file server. The reason seems to be
  134.     related to the way VC++ 4.0 changes the case name of the pdb
  135.     filename it is passed on the command line. It seems to change
  136.     the name always to to lower case. I contend that
  137.     the VC++ compiler should not change the casename of files that
  138.     are passed as arguments on the command line. I don't think this
  139.     was a problem in MSVC 2.x, but I know it is a problem in MSVC 4.x.
  140.  
  141.     The package builds fine on VFAT and NTFS filesystems.
  142.  
  143.     Most all of the development I have done to date has been using
  144.     NTFS and long file names. I have not done any considerable work
  145.     under VFAT. VFAT users may wish to be aware that this port
  146.     of make does respect case sensitivity.
  147.  
  148.     Version 3.76 contains some preliminary support for FAT.     Make
  149.     now tries to work around some difficulties with stat'ing of
  150.     files and caching of filenames and directories internally.
  151.     There is still a known problem with filenames sometimes being
  152.     found to have modification dates in the future which cause make
  153.     to complain about the file and exit (remake.c).
  154.  
  155. Bug reports:
  156.  
  157.     Please submit bugs via the normal bug reporting mechanism
  158.     which is described in one of the Texinfo files. If you don't
  159.     have Texinfo for Windows NT or Windows 95, these files are simple
  160.     text files and can be read with a text editor.
  161.  
  162.